home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / xlax_102.arc / XLAXNODE.DOC < prev    next >
Text File  |  1988-05-19  |  58KB  |  1,452 lines
  1.  
  2.  
  3.      XLAXNODE                                                        Page 1
  4.  
  5.                                     XLAXNODE
  6.                             Express Nodelist Builder
  7.                               Copyright 1987, 1988
  8.                                  By Scott Samet
  9.                           Friends of Dorothy 1:135/990
  10.  
  11.  
  12.  
  13.  
  14.      This is a nodelist processor designed to consolidate many of the
  15.      nodelist processing functions needed by an FidoNet sysop into a single
  16.      FAST program.  This version adds support for Opus 1.10, Binkley 1.40
  17.      and PC Pursuit 2400 baud service.
  18.  
  19.  
  20.                                 Acknowledgements
  21.  
  22.      This program was inspired, in part, by the work done by Thom Henderson
  23.      in XLATLIST and Rick Huebner in PCPEXCH.  Thanks to Rick for
  24.      permission to include his sample PCPEXCH data and script files.
  25.      Credit also goes to Mike Janke (135/4) and Chris Baker (135/14 aka
  26.      18/0 & 135/0) who put up with all sorts of stupid questions when I
  27.      didn't know an Opus from an ice cube.  And to the sysops of Net 135,
  28.      especially Henry Van Leer (135/27) who tested version 0.0 and used it
  29.      anyway!  Most of the support for Seadog functions is a result of Chris
  30.      Baker and Al de la Torre (135/7) sending netmail messages that started
  31.      "Why doesn't it..."
  32.  
  33.  
  34.                                     License
  35.  
  36.      The program and associated documentation are Copyright.  They are
  37.      distributed as SmileWare <probably tm>.
  38.  
  39.      DISTRIBUTION:
  40.           You may distribute the program on magnetic media or via modem
  41.           provided you observe the following restrictions:  You do not add,
  42.           delete, change or rename the distribution file or anything in it.
  43.           You may not request or accept money, sex, drugs or other
  44.           compensation.
  45.  
  46.      USE:
  47.           Prior to using this program, seat your mirror shades firmly on
  48.           the bridge of your nose, fasten your seat belt, hold up your
  49.           right hand and repeat the following:  "I, (state your name), do
  50.           solemnly swear or affirm that I will use this program in a lawful
  51.           and friendly fashion, observe OPOL0.DOC and will never even think
  52.           of mentioning controversial subjects such as religion or 9600
  53.           baud modems in MEADOW."
  54.  
  55.      DONATION:
  56.           Money sent to Scott Samet, PO Box 162082, Miami, FL 33216 USA,
  57.           would indicate that user supported software is appreciated.
  58.           $20 is suggested, however less is better than nothing.  Wives,
  59.           lovers, children and livestock are not accepted by the US Postal
  60.           Service and UPS cannot deliver to PO Boxes.
  61.  
  62.  
  63.  
  64.      XLAXNODE                                                        Page 1
  65.  
  66.      XLAXNODE                                                        Page 2
  67.  
  68.                                     Warranty
  69.  
  70.      Nil, naught, none, nunca, nada, nyet.  No warranty expressed, implied,
  71.      impugned, indulged, imagined or ever considered.  Distributed on an
  72.      as-is basis.  Use at your own risk.  Not responsible for incidental,
  73.      consequential, transcendental, accidental, real, imagined or any other
  74.      damage.  Using this program indicates your acceptance of these terms.
  75.  
  76.      On the other hand, I'm proud of the program, and want it to be bug
  77.      free.  Problem reporting procedures are detailed at the end of this
  78.      document.
  79.  
  80.                                 What does it do?
  81.  
  82.      Produces one or more of the following files:
  83.  
  84.           NODELIST.BBS  In Fido, Opus or Seadog format,
  85.           NODELIST.FON     compatible with XlatList 2.84
  86.           NODELIST.SYS  For Opus systems,
  87.           NODELIST.IDX     compatible with
  88.           NODELIST.DAT        OpusNode 1.4.6 and ParseLst
  89.           NODELIST.DOG  For Seadog
  90.           NETLIST.DOG      systems, compatible
  91.           INDEX.DOG           with NLCOMP 4.16
  92.           FIDOUSER.LST  Username file
  93.           NODELIST.PRN  Human-readable nodelist, 132 columns
  94.           NODELIST.TXT    "      "         "     80 columns
  95.           NODELIST.DBL    "      "         "     two 80 column lines/node
  96.           COORD.nnn       "      "     Zone, Region and Net nodelist
  97.           NODETEXT.BBS  Human-readable nodelist, online view format
  98.           NODELIST.DLM  Delimited nodelist for other<tm> programs
  99.  
  100.      The program will also do the nodelist processing required to support
  101.      PC Pursuit scripts for BinkleyTerm and Opus 1.03 and 1.10
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.      XLAXNODE                                                        Page 2
  128.  
  129.      XLAXNODE                                                        Page 3
  130.  
  131.                                    OPERATION
  132.  
  133.      There are some differences between this program and the program(s) you
  134.      are probably using.  You may get an error message or even different
  135.      results.  Take a time to read the docs and avoid problems.
  136.  
  137.      This version expects ANSI.SYS (or equivalent) to be loaded.  When used
  138.      under DOS 2.x, the EXE file must reside in the current directory; the
  139.      DOS PATH will not suffice. It should work on most "non-IBM-Compatible"
  140.      MS-DOS machines.
  141.  
  142.      XLATLIST processes DIAL and COST strings in the order you enter them.
  143.      If you have the same string more than once, XLATLIST will ignore the
  144.      extra ones.   You will now get an error message.  You need to figure
  145.      out why you have duplicates, and fix your input file.  If you have a
  146.      shorter string before a longer one, e.g. "1-305" before "1-305-555",
  147.      than XLATLIST will never use the longer string.  The strings are
  148.      sorted and the longest processed first.  In the previous example, both
  149.      strings will be used.  Failure to heed these warnings will result in
  150.      different output than you are used to getting.
  151.  
  152.      Many sysops will be able to use their existing XLATLIST.CTL files
  153.      unaltered.  If you're running XLATLIST in the Opus mode, and following
  154.      it with OPUSNODE -f, then you should be able to run XlaxNode with no
  155.      switches and you're done.  The dummy control file (XLAXNODE.CTL)
  156.      included with the program contains an INCLUDE statement to read your
  157.      existing XLATLIST.CTL file.
  158.  
  159.      XLAXNODE.CTL is the first file read.  This contains control statements
  160.      to direct further operation.  Unless you override the defaults, it
  161.      will search the current directory for files named NODELIST.nnn,
  162.      looking for the highest number.  That file will be used as the raw
  163.      nodelist input file.  By default, three files are written:
  164.      NODELIST.BBS, which is used by Fido and Seadog systems and some
  165.      special purpose utilities, and NODELIST.SYS and NODELIST.IDX which are
  166.      the only files actually used by Opus v1.03.
  167.  
  168.      XLAXNODE.CTL is a standard Ascii text file.  Each control statement is
  169.      entered on a separate line.  A semi-colon indicates that the rest of
  170.      the line is to be treated as comments.  Blank lines or lines starting
  171.      with semi-colons are also comments.  No line, even a comment line, may
  172.      exceed 255 characters in length.
  173.  
  174.      You may augment or override commands in the control file by placing
  175.      them on the DOS command line.  Commands that require arguments must be
  176.      enclosed in Ascii quotes (").  The COST and DIAL commands require
  177.      multiple lines and cannot be placed on the DOS command line.  For
  178.      example, if you are running a temporary modem at 1200 baud, you might
  179.      enter:
  180.           XLAXNODE "MAXBAUD 1200"
  181.      This is the same as including the corresponding statement at the end
  182.      of your control file.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.      XLAXNODE                                                        Page 3
  191.  
  192.      XLAXNODE                                                        Page 4
  193.  
  194.      If an error occurs during processing, XlaxNode will terminate and
  195.      return an error code that can be tested in the batch file.  Error
  196.      codes and their causes are:
  197.  
  198.         0       Normal completion, no errors.
  199.         1       Control file turned off all output files.
  200.         5       Not enough memory.  Array full or heap overflow.
  201.         6       No NODELIST.nnn file found to process.
  202.         7       Error in a control statement.
  203.         8       Attempt to open a file failed.
  204.         9       Sort or Disk I/O Error occured.
  205.  
  206.  
  207.                                     COMMANDS
  208.  
  209.      INCLUDE filename
  210.  
  211.           Indicates an auxiliary file containing XlaxNode Control
  212.           statements.  XlaxNode will read and process the named file, then
  213.           continue with the next statement in the current file.  Include
  214.           files may be nested, subject to DOS limits on the number of files
  215.           open.
  216.  
  217.      UPDATE command-string
  218.      NOUPDATE
  219.  
  220.           Allows you to invoke a nodelist update program (XlaxDiff, or
  221.           equivalent) before processing begins.  Command-string is the full
  222.           command, including all arguments, just as you would type it at
  223.           the DOS prompt.  If the program returns an error code greater
  224.           than 1, processing will be aborted.  Example:
  225.  
  226.                UPDATE XlaxDiff /E=D:\NetFiles /C
  227.  
  228.      NODE <zone>:<net>/<node>
  229.  
  230.           This is REQUIRED.  Enter YOUR node number.  Example:
  231.  
  232.                NODE 1:234/567
  233.  
  234.      COUNTRY
  235.  
  236.           Here's where you enter the international telephone prefix for
  237.           your country.  The default is "1-", which is shared by the US,
  238.           Canada and some little specks in the Atlantic.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.      XLAXNODE                                                        Page 4
  254.  
  255.      XLAXNODE                                                        Page 5
  256.  
  257.      FIDO
  258.      SEADOG
  259.      OPUS
  260.  
  261.           Pick one.  Or don't pick one, if you're willing to accept OPUS as
  262.           the default.  This controls some quirks in the format and content
  263.           of the output files to support the different systems.  Most of
  264.           the differences have to do with how Zones, Hubs and Flags are
  265.           handled.
  266.  
  267.           If you are running Opus and Seadog, then you will need to run the
  268.           program once in each mode in order to get all your files.  See
  269.           the section about entering options on the command line.  Be sure
  270.           to do the Opus run before the Seadog run, since many Seadog
  271.           utilties will run (or attempt to run) NLCOMP if they find that
  272.           the NODELIST.BBS file has a later timestamp than the Seadog
  273.           nodelist files.
  274.  
  275.      FIDOPRN
  276.      FIDOTXT
  277.      FIDODBL
  278.      NOFIDOLIST
  279.  
  280.           Gives you a people-readable version of the nodelist.  FIDOPRN is
  281.           132 columns wide.  FIDOTXT is 80 columns wide.  FIDODBL is 80
  282.           columns wide, but uses two lines per node, like the LISTGEN
  283.           output file that I am not old enough to remember.  You may ask
  284.           for any or all, even if you are in OPUS or SEADOG mode.  The
  285.           default, NOFIDOLIST means you don't want this disk space hog.
  286.           See the section on PC Pursuit processing for information on how
  287.           the contents of these files are modified for Pursuitable nodes.
  288.           Also see SQUEEZE.
  289.  
  290.      INDEX
  291.      SINDEX
  292.      NOINDEX
  293.  
  294.           Appends an index to the FIDODBL, FIDOPRN and FIDOTXT lists.
  295.           SINDEX is sorted by Zone/Region/Net number, INDEX is in the same
  296.           order as the lists.  NOINDEX is the default.  If NOFIDOLIST is
  297.           selected, then you can't very well have an index, can you?
  298.  
  299.      SQUEEZE
  300.      NOSQUEEZE
  301.  
  302.           Reduces the size of the FIDOLIST files by replacing strings of
  303.           blanks with tabs.  Reductions of 15-35% are typical, as are
  304.           similar increases in execution time.  NOSQUEEZE is the default.
  305.           You may wish to avoid this option if you are using any kind of
  306.           program to read the FIDOLIST files.  Some programs are confused
  307.           if the input file contains tabs, buttons or suspenders.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.      XLAXNODE                                                        Page 5
  317.  
  318.      XLAXNODE                                                        Page 6
  319.  
  320.      NODETEXT [<headerfilename> [<trailerfilename>]]
  321.      NONODETEXT
  322.  
  323.           Another people-readable version of the nodelist.  This is
  324.           formatted for online viewing.  There are no page breaks or form
  325.           feeds. If headerfilename and trailerfilename are specified, these
  326.           files are inserted at the start and end of the generated report.
  327.           You can insert a introductory message and/or oANSI control
  328.           commands. See the section on PC Pursuit processing for
  329.           information on how the contents of this file is modified for
  330.           Pursuitable nodes.  Also see SQUEEZE.
  331.  
  332.      USERLIST
  333.      INTERLIST
  334.      NOUSERLIST
  335.  
  336.           Creates an alphabetical directory of sysops and their node
  337.           numbers.  USERLIST is just for your Zone, INTERLIST is for all
  338.           Zones.  The default, NOUSERLIST is for the No-Zone.
  339.  
  340.      ADDR
  341.  
  342.           This XLATLIST command has been replaced by the ADDRLIST command.
  343.  
  344.      ADDRLIST filename
  345.  
  346.           This command refers to a personal file of names and node numbers
  347.           that will be added to the FidoUser.Lst file.  If one of these
  348.           names exists in the nodelist, the address specified here will
  349.           override the one that would normally be selected.
  350.  
  351.           The file is a standard ASCII text file. Each line has the
  352.           following format:
  353.  
  354.                Address_String User_Name_String
  355.  
  356.           Address may be any string up to twenty characters.  Seadog allows
  357.           non-FidoNet addresses, so the address is not edited.  Neither the
  358.           address or name field may have any embedded blanks.  Example:
  359.  
  360.                1/1 Fido_News
  361.                1/1 FidoNews
  362.                3:3/0 Zone_Three_Cooord
  363.                Palace!EmeraldCity!OZ I_D'Wiz
  364.  
  365.      REPORT
  366.      NOREPORT
  367.  
  368.           Generates a cute little report about how many nodes there are,
  369.           how many are down, on hold and private.  Since the program
  370.           doesn't have any limits on the number of nodes, why do you care?
  371.  
  372.      PROGRESS
  373.      NOPROGRESS
  374.  
  375.           Displays the input filename, zone, region and net number while
  376.           the nodelist is being scanned.  Using this option with a speech
  377.           board will really slow things down.  NOPROGRESS suppresses this
  378.           display.  PROGRESS is the default.
  379.  
  380.      XLAXNODE                                                        Page 6
  381.  
  382.      XLAXNODE                                                        Page 7
  383.  
  384.      COMMENTS
  385.      NOCOMMENTS
  386.  
  387.           Copies any comments from the raw nodelist the report file as they
  388.           are read.  You should be aware that error messages from the
  389.           nodelist creation utilities are inserted in the nodelist as
  390.           comments.  All I do is display them when the nodelist is
  391.           compiled.  I don't create these messages, so please don't write
  392.           and ask me to explain them.  NOCOMMENTS is the default.
  393.  
  394.      DASH
  395.      NODASH
  396.  
  397.           The exciting NODASH option strips the dashes out of phone numbers
  398.           written to the NODELIST.BBS, NODELIST.SYS and NODELIST.DAT files.
  399.           Some modems get upset if the dial strings are too long, and this
  400.           can make them shorter.  It also makes them very difficult to
  401.           read.  DASH is the default.  Unlike Other<tm> programs, XlaxNode
  402.           still knows if a number is domestic or international, even if the
  403.           dashes are removed.
  404.  
  405.      NODELIST
  406.      NONODELIST
  407.  
  408.           Writes the NODELIST.BBS file.  The contents of this file will
  409.           vary based on the Fido/Opus/Seadog switch.  This file is not used
  410.           by XlaxNode.  There is no need to create it unless you are doing
  411.           Other<tm> nodelist processing.  NONODELIST is the default.
  412.  
  413.      OPUSLIST
  414.      NOOPUSLIST
  415.  
  416.           Writes the Opus files NODELIST.IDX and NODELIST.SYS or
  417.           NODELIST.DAT.  This option is only effective if you're running in
  418.           OPUS mode.  OPUSLIST is the default.
  419.  
  420.      OPUSOLD
  421.      OPUSNEW
  422.  
  423.           Controls the files produced by OPUSLIST.  OPUSOLD is the default
  424.           and causes the NODELIST.SYS file and Opus 1.03 format
  425.           NODELIST.IDX to be written.  OPUSNEW causes the NODELIST.DAT file
  426.           and Opus 1.10 format NODELIST.IDX to be written.
  427.  
  428.      SEADOGLIST
  429.      NOSEADOGLIST
  430.  
  431.           Writes the NODELIST.DOG, NETLIST.DOG and INDEX.DOG files.  This
  432.           option is only effective if you're running in SEADOG mode, in
  433.           which case SEADOGLIST is the default.
  434.  
  435.  
  436.      COORDLIST
  437.      NOCOORDLIST
  438.  
  439.           Creates a file named COORD.nnn, where nnn is the number of the
  440.           input nodelist.  This is a human readable text file listing the
  441.           Zone, Region and Net coordinators.
  442.  
  443.      XLAXNODE                                                        Page 7
  444.  
  445.      XLAXNODE                                                        Page 8
  446.  
  447.      FRONTDOOR
  448.      NOFRONTDOOR
  449.  
  450.           Writes the USERLIST.BBS for FrontDoor. NOFRONTDOOR is the
  451.           default.
  452.  
  453.      DELIMITEDFILE
  454.      NODELIMITEDFILE
  455.  
  456.           This is a parsed version of the nodelist formatted for loading
  457.           into dBASE, Lotus, Reflex or the like.  A detailed file
  458.           description is given near the end of this document.
  459.  
  460.      MAXBAUD nnnn [flag mmmm]
  461.  
  462.           Tells the maximum speed of your modem.  This value will replace
  463.           the speed of any faster nodes.  Opus and Binkley obtain this
  464.           information from their configuration files.  The optional
  465.           flag mmmm pair specifies a second baud rate to be used if "flag"
  466.           appears in the flags field of the nodelist entry.  Examples:
  467.  
  468.                MAXBAUD 1200          ; All calls limited to 1200
  469.                MAXBAUD 2400 HST 9600 ; Calls to HST at 9600 others at 2400
  470.  
  471.      PUBLIST nodelistname
  472.  
  473.           This allows you to override the standard name, NODELIST, for the
  474.           input file.  Enter only the 1-8 character file name.  Do NOT
  475.           enter the period or file type.  The program will search for the
  476.           highest numbered list.  Multiple Public lists are NOT supported.
  477.           Use MYLIST or PVTLIST for any additional lists, such as AlterNet
  478.           or EggNet.
  479.  
  480.           Nodelistname will also be used for some of the output files.  If
  481.           you enter:
  482.  
  483.                PUBLIST TESTNODE
  484.  
  485.           Then NODELIST.BBS, .SYS, and .IDX will be named TESTNODE.BBS,
  486.           .SYS and .IDX respectively.
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.      XLAXNODE                                                        Page 8
  507.  
  508.      XLAXNODE                                                        Page 9
  509.  
  510.      MYLIST  <filename>...
  511.      PVTLIST <filename>...
  512.  
  513.           These two keywords allow you to specify additional nodelists.
  514.           Entries from MYLIST files will be included in the human readable
  515.           nodelists.  PVTLIST file entries will not.  By popular demand,
  516.           and against my better judgement, FSC002 is relaxed to permit
  517.           spaces and tabs in these lists.
  518.  
  519.           The OneZone/AllZones keywords do not affect these nodelists.
  520.           Zones selection is ignored and all entries are written to the
  521.           output files.  They will be merged into the nodelist at the end
  522.           of your zone.  This means that if the list(s) do not contain zone
  523.           statements, they will be included in your zone.
  524.  
  525.           Opus 1.03 and Seadog may have problems if net numbers are
  526.           duplicated.  The OZone keyword may be used to adjust net numbers
  527.           in this situation.
  528.  
  529.           You may include as many file names as will fit on the line and
  530.           use as many of these statements as you wish.  Use "###" as the
  531.           file type to select the highest numbered nodelist.  Example:
  532.  
  533.                MYLIST ANETLIST.###
  534.                PVTLIST POINT1.NET POINT2.NET
  535.  
  536.      ROUTE
  537.      NOROUTE
  538.  
  539.           Writes NODELIST.FON, the SEADOG routing work file.  Rumor has it
  540.           that this file is sometimes used by non-Seadog sysops, so it can
  541.           be produced even if you are not in Seadog mode.  Default is
  542.           NOROUTE.  See the PURSUIT section for information about how
  543.           PC Pursuit processing modifies the contents of this file.
  544.  
  545.      IGATE [<zone>:[<net>/]]node
  546.      OGATE [<zone>:[<net>/]]<node>
  547.      GATE  [<zone>:[<net>/]]<node>
  548.      HUB   [<zone>:[<net>/]]<node>
  549.  
  550.           The specified nodes will be marked in the NODELIST.FON files.  In
  551.           SeaDog mode, they will also be marked in the NODELIST.BBS file.
  552.           Network host nodes are always marked as IGATE nodes and Network
  553.           hub modes are always marked as HUB nodes.  You need to enter
  554.           these statments only for nodes that are not marked automatically.
  555.           These commands may be repeated.
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.      XLAXNODE                                                        Page 9
  570.  
  571.      XLAXNODE                                                       Page 10
  572.  
  573.      PHONE [<zone>:[<net>/]]<node> <phonenumber>
  574.  
  575.           Allows you to override a node's phone number.  If net is omitted,
  576.           your net will be assumed.  This statement can be repeated as
  577.           required.  Entering a phone number for a private node will cancel
  578.           the node's private status and host routing.  Example:
  579.  
  580.                PHONE 135/990 1-305-555-1212
  581.  
  582.           You should enter the phone number in exactly the same format as
  583.           the numbers in the nodelist (and the example above).  Use the
  584.           DIAL translation to make any required alterations to the phone
  585.           number.
  586.  
  587.      FLAG [<zone>:[<net>/]]<node> <+/=><flagstring>
  588.  
  589.           Allows you to replace or append to a node's flags.  If net is
  590.           omitted, your net will be assumed.  A equal sign replaces a nodes
  591.           flags, a plus appends to them.  You should enter the flags in
  592.           exactly the same format as the nodelist.  This statement can be
  593.           repeated as required.  Examples:
  594.  
  595.                FLAG 135/990 +#CM: ; adds #CM: flag to existing flags
  596.                FLAG 135/990 =#CM: ; replaces flags with #CM:
  597.  
  598.      BAUD [<zone>:[<net>/]]<node> <speed>
  599.  
  600.           Allows you to override a node's baud rate.  If zone or net is
  601.           omitted, your own will be assumed.  This statement can be
  602.           repeated as required. Example:
  603.  
  604.                BAUD 135/990 56000 ; Can't you just wait for this modem?
  605.  
  606.      PASSWORD [<zone>:[<net>/]]<node> password
  607.  
  608.           Allows you to enter a password into the Nodelist. They make no
  609.           sense unless the OPUSLIST switch is set.  If OpusNew is in
  610.           effect, passwords are truncated to eight characters; if OpusOld
  611.           is in effect, they are truncated to six.  Like PHONE or BAUD,
  612.           this command may be repeated as desired.  If you specify a
  613.           password for a private node, the program will issue a warning
  614.           message and cancel the node's host routing.  Example:
  615.  
  616.                PASSWORD 135/1 HotWoc
  617.  
  618.      PASSWORDFILE filename
  619.  
  620.           Provides an alternate method of entering passwords into the
  621.           Nodelist.  The file is a standard ASCII text file. Each line has
  622.           the following format:
  623.  
  624.                Net/Node Password
  625.  
  626.           Example:
  627.  
  628.                135/1 HotWoc
  629.                135/2 P42JW9
  630.                135/3 PW4ME2
  631.  
  632.      XLAXNODE                                                       Page 10
  633.  
  634.      XLAXNODE                                                       Page 11
  635.  
  636.      WARTS
  637.      NOWARTS
  638.  
  639.           This controls the logic used for Hold and Private nodes.  WARTS
  640.           duplicates the logic used by XlatList 2.84, OpusNode and NlComp.
  641.           NOWARTS uses the host or hub node's Phone, Speed, Cost, Password
  642.           and Flags.  NOWARTS is the default.
  643.  
  644.      ONEZONE
  645.      ALLZONES
  646.  
  647.           Selects your zone or all zones to be included in the output
  648.           files.  Opus 1.03 and Seadog are prepared to handle multiple
  649.           zones.  Using the AllZone option in these modes can result in
  650.           duplicate node numbers.  Do so at your own risk.  ONEZONE is the
  651.           default.
  652.  
  653.      SORTWORK filename
  654.  
  655.           If a sort cannot be completed in memory, a disk work file will be
  656.           created and deleted when no longer needed.  SORTWORK controls
  657.           where the file will be placed.  You may specify a full drive,
  658.           path and file name.   An Extended or Expanded Memory ramdisk is
  659.           an ideal place for this file.  If this statement is omitted, the
  660.           file will be created in your current directory.  The SEADOG,
  661.           SINDEX, and USERLIST/INTERLIST options trigger sorts, although
  662.           only the user lists are likely to overflow to disk.
  663.  
  664.      BUFFERS <number>
  665.  
  666.           Allows you to increase or decrease the size of the file I/O
  667.           buffers used by the program.  The default is 4; values of 1 to 8
  668.           may be specified.  If you specify too large a value, the program
  669.           will abort with a Heap Overflow message.  For best performance,
  670.           use the largest value that will allow the program to run without
  671.           any of the sorts giving a message that a disk work file has been
  672.           used.  Example:
  673.  
  674.                BUFFERS 6
  675.  
  676.      OZONE <zone>:<net>  [<newnet>]
  677.  
  678.           Causes a net from another zone to be "imported" into your own
  679.           zone.  Since net numbers are not unique in different zones, you
  680.           may need to specify a new net number.  You may repeat this
  681.           command as required.
  682.  
  683.           The command affects the Opus 1.03 (Nodelist.BBS, Nodelist.Sys,
  684.           and Nodelist.Idx) and Seadog (Nodelist.BBS, Nodelist.Dog,
  685.           Netlist.Dog, Index.Dog, and Nodelist.Fon) files.
  686.  
  687.           Example:
  688.  
  689.                OZONE 2:500       ; Sweden will appear as net 500
  690.                OZONE 2:501 20501 ; Norway will appear as net 20501
  691.  
  692.  
  693.  
  694.  
  695.      XLAXNODE                                                       Page 11
  696.  
  697.      XLAXNODE                                                       Page 12
  698.  
  699.      DIAL <domestic> <international>
  700.  
  701.           It's unlikely that you will be able to use the numbers from the
  702.           nodelist exactly as they are.  If 1-305-555-1212 is a local call,
  703.           the phone company is likely to laugh at you if you try to dial
  704.           all 10 digits.  Numbers in the nodelist need to be "munged" into
  705.           a format acceptable to Mother Bell (or Gee Hee Hee).  The DIAL
  706.           table is a set of rules for that job.  It starts with a DIAL
  707.           line, contains zero or more detail lines, and finishes up with an
  708.           END statement.
  709.  
  710.           Each detail line in the DIAL table consists of a search part and
  711.           a replacement part.  The search part of each line is matched
  712.           against a node's phone number.  As soon as a match is found, the
  713.           part matched is replaced, and processing continues with the next
  714.           phone number.  Assume the following line in the DIAL table:
  715.                1-305-555  555   ; Search for "1-305-555" replace with "555"
  716.           If the phone number is 1-305-555-1212, then the 1-305-555 will be
  717.           replaced by 555 and the result is 555-1212.  This is the normal
  718.           format for a local call.  You'll probably want a DIAL line like
  719.           this for every local prefix.
  720.  
  721.           Now consider long distance within your own area code.  You
  722.           probably need to dial 1 and the seven digit number.  After
  723.           listing all your local prefixes in the DIAL list, make the
  724.           following entry:
  725.                1-305-   1-
  726.           If the 1-305-976 prefix was not individually included in the DIAL
  727.           list, then this entry would change 1-305-976-1212 into
  728.           1-976-1212.
  729.  
  730.           If you can dial your entire area code without a 1- prefix, then
  731.           you don't need to detail the local exchanges.  Just specify:
  732.                1-305- /
  733.           This will strip the 1-305- from every number in the area code.
  734.  
  735.           For most places, this about covers it.  For long distance calls
  736.           outside your own area code, you dial the number just as it
  737.           appears in the nodelist.
  738.  
  739.           Here's an abbreviated version of my DIAL list:
  740.                DIAL / 011-/#
  741.                1-305-222 222            ; local call
  742.                1-305-223 223            ; local call
  743.                     .
  744.                     .
  745.                     .
  746.                1-305-939 939            ; local call
  747.                1-305     1-             ; long distance within 305
  748.                END
  749.  
  750.           If you're sharp, you're wondering about the / 011-/# on the DIAL
  751.           statement.  The entries on the DIAL statement specify what to do
  752.           if NONE of the DIAL lines match.  For domestic calls, we don't
  753.           need to do anything.  The first slash just serves as a place
  754.           holder so nothing gets done to domestic numbers.  For
  755.           international calls we need to insert 011- in front of the
  756.           number.  Inserting # at the end of international numbers speeds
  757.           completion of the call.
  758.  
  759.      XLAXNODE                                                       Page 12
  760.  
  761.      XLAXNODE                                                       Page 13
  762.  
  763.           If you're connected to a switchboard that needs 9 before all
  764.           local calls, and 8 before all long distance calls, then your
  765.           table might look like this:
  766.                DIAL 8 8-011
  767.                1-305-222 9-222          ; local call
  768.                1-305-223 9-223          ; local call
  769.                     .
  770.                     .
  771.                     .
  772.                1-305-939 9-939          ; local call
  773.                1-305-    8-1-           ; long distance within 305
  774.                END
  775.  
  776.           Suppose that you want to use a dial-up long distance carrier for
  777.           those places not listed in your dial list.  The following DIAL
  778.           statement would do the job:
  779.                DIAL 950-1234W9876* 011-
  780.           This is saying, if a domestic phone number does not match
  781.           anything in the DIAL list, then insert 950-1234W9876* before the
  782.           number.   International numbers would still get a 011- prefix.
  783.  
  784.           Until now, I've ignored a feature that will not be used by many
  785.           people.  In addition to inserting things before the phone number,
  786.           you can append things to the end of phone number.  That's where
  787.           the slash comes into play.  If your long distance company wanted
  788.           the security code AFTER the number, the DIAL statement would look
  789.           like this:
  790.                DIAL 950-1234W/*9876 -011
  791.           This says to insert 950-1234W in front of the number and *9876
  792.           after the number.  When I called the slash a place holder
  793.           earlier, it was saying to insert nothing before and nothing after
  794.           the number.
  795.  
  796.           You can use the slash in a DIAL detail line as well.  If you
  797.           wanted to use the dial up service within my your area code, then
  798.           the line in your DIAL table would look like this:
  799.                1-305- 950-1234W/*9876
  800.  
  801.           This would turn 1-305-976-1212 into 950-1234W976-1212*9876.
  802.  
  803.      NOTE!
  804.           There is a difference in the way that XLATLIST and I handle dial
  805.           entries.  XLATLIST searches them in the order entered, so if you
  806.           had entered:
  807.                1-305   1-
  808.                1-305-555  555
  809.           XLATLIST would NEVER use the second line.  I sort them and always
  810.           search the longest ones first, so I WOULD find and use the second
  811.           line.  If you enter strings in a sequence that will result in
  812.           output different from XLATLIST, a warning message will be
  813.           generated.
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.      XLAXNODE                                                       Page 13
  823.  
  824.      XLAXNODE                                                       Page 14
  825.  
  826.           As far as the program is concerned, domestic is any number that
  827.           has the prefix specified in the COUNTRY statement (defaulting to
  828.           1-).  Canada, Bermuda, parts of Mexico and the Caribbean Islands
  829.           are dialed as domestic calls.  You may have 1+ long distance
  830.           service from a company that do not handle all these places.  If
  831.           you are using one of these companies, you will need something
  832.           like:
  833.                1-416 10288-1-416
  834.           to send these calls via AT&T.
  835.  
  836.           A little hint: The discount periods for foreign places are not
  837.           the same as for the US.  From the US to Canada, lowest rates are
  838.           midnight to 8 am, seven days a week.  Weekend daytime is NOT the
  839.           lowest rate.
  840.  
  841.      COST <domestic> <international> [<special>]
  842.  
  843.           The COST table assigns prices to be charged for Network (Matrix)
  844.           mail.  It is structured a lot like the DIAL table.  It begins
  845.           with a COST statement, has one or more detail lines, and finishes
  846.           with an END statement.
  847.  
  848.           The COST statement itself accepts three values, the price (in
  849.           pennies) of domestic, international and special nodes.  These
  850.           prices are defaults for any number that is not listed in the
  851.           detail section.  Special nodes are private nodes that you have
  852.           assigned a password.  They cannot be host routed, and there is no
  853.           phone number available, so this cost will be used.  If omitted,
  854.           it defaults to the domestic value.
  855.  
  856.           Lines in the detail section start like lines in the DIAL list,
  857.           with a partial phone number to search for.  Each search string is
  858.           followed by a cost, and an optional baud rate.  The baud rate
  859.           becomes an upper limit for calls to the numbers specified.
  860.  
  861.           Rather than continue with rules, an example should make it clear.
  862.  
  863.                COST 35 125
  864.                1-305-222 222 0          ; local call
  865.                1-305-223 223 0          ; local call
  866.                     .
  867.                     .
  868.                     .
  869.                1-305-939 939 0          ; local call
  870.                1-305        25          ; my own area code.
  871.                1-813        25          ; other places in Fla.
  872.                1-904        25          ; rest of Fla.
  873.                1-809-422    50 1200     ; Nassau
  874.                1-809-423    50 1200     ; Nassau
  875.                1-809        75          ; Bermuda, Bahamas, Etc.
  876.                1-905        90          ; Mexico
  877.                1-416        50          ; Ontario Canada
  878.                1-514        50          ; Quebec Canada
  879.                      .
  880.                      .
  881.                      .
  882.                1-800         0          ; Free Call
  883.                END
  884.  
  885.      XLAXNODE                                                       Page 14
  886.  
  887.      XLAXNODE                                                       Page 15
  888.  
  889.           This first few lines make local E-Mail free.  Calls to the rest
  890.           of Florida are 25 cents.  Calls to Nassau are fifty cents, and no
  891.           matter what the speed in the nodelist, I want to call at no more
  892.           than 1200 baud.  The rest of area 809 is 75 cents.  Calls to
  893.           Mexico are 90 cents, etc.  Any place not mentioned in the list
  894.           will be 35 cents if it starts with the 1- prefix, and $1.25
  895.           otherwise.
  896.  
  897.  
  898.      PURSUIT <filename> <cost> <baud>
  899.      NOPURSUIT
  900.  
  901.           This command enables special processing for Opus sysops with PC
  902.           Pursuit.  Before I start with the details of Pursuit processing,
  903.           I want to make a comment about the cost field.  The default is
  904.           one cent.  Opus considers any node with a zero cost to be a local
  905.           call.  If you have your behavior windows set up to allow local
  906.           calls during the day, then Opus will place daytime Pursuit calls
  907.           and you'll be billed $10 - $14/hr.  By setting the cost of a
  908.           Pursuit message to a penny, Opus will not consider it a local
  909.           call and avoid the high-rent periods.
  910.  
  911.           Baud is the maximum speed to be used for PC Pursuit.  You should
  912.           set it to 2400 (the default) unless you do not have a 2400 baud
  913.           in-dial to Telenet.  For any given node, the program will use the
  914.           lowest of the node's baud rate, Telenet's outdial rate (from the
  915.           data file described below) for the node's city, the rate
  916.           specified here and MAXBAUD.   Even if it's not clear, it works
  917.           perfectly.
  918.  
  919.           Filename refers to a file listing the area codes and numbers that
  920.           can be dialed by PC Pursuit.  These numbers receive special
  921.           treatment during DIAL processing.   For these discussions, I'll
  922.           assume that you have specified:
  923.  
  924.                PURSUIT PCP
  925.  
  926.           If you use a different filename, then you'll have to make the
  927.           necessary adjustments.
  928.  
  929.           If you are running Opus 1.03, you will need PCP.INP, a skeleton
  930.           script file used to create scripts for reaching each Pursuit
  931.           node.  If you are running Binkley or Opus 1.10, you will need
  932.           PCP.SCR, which is not used by this program, but will be used by
  933.           Opus when you place a call to one of these nodes.  The sample
  934.           script files included with XlaxNode are just that, samples.  Do
  935.           not expect them to work in your environment without modification.
  936.  
  937.           You'll need a file called PCP.DAT containing a list of area codes
  938.           and exchanges that can be reached via PC Pursuit.  A sample
  939.           PCP.DAT is included, but Telenet is actively adding new cities.
  940.           The basic skeleton of the PCP.DAT file can be downloaded from the
  941.           Pursuit bulletin board.  Each line begins with an area code,
  942.           starting in column one, followed by a list of exchanges within
  943.           that area code.  Exchanges need not be in sequential order.  For
  944.           example:
  945.  
  946.                305     223 226 227 232 233 235 238 250 251 252
  947.  
  948.      XLAXNODE                                                       Page 15
  949.  
  950.      XLAXNODE                                                       Page 16
  951.  
  952.           This information should already be in the file when you download
  953.           it.  Insert a header line in front of each city.  It's a standard
  954.           Ascii text file, so use your favorite text editor.  The header
  955.           line consists of the word "NODE" in column one, a space and the
  956.           name assigned to the outdial city by Telenet, another space and
  957.           the maximum outdial baud for that city.
  958.  
  959.                NODE D/DCWAS 2400
  960.  
  961.           The Washington outdial node handles calls for area 202 and parts
  962.           of 301 and 703.  You should list all three area codes under a
  963.           single header:
  964.  
  965.                NODE D/DCWAS 2400
  966.                202    xxx xxx xxx xxx xxx xxx
  967.                202    xxx xxx xxx xxx xxx xxx
  968.                301    xxx xxx xxx xxx xxx xxx
  969.                301    xxx xxx xxx xxx xxx xxx
  970.                703    xxx xxx xxx xxx xxx xxx
  971.                703    xxx xxx xxx xxx xxx xxx
  972.  
  973.           The New York outdial node serves 212 and 718, but you must dial
  974.           1-718 before calls to the latter.  In this case you have a PREFIX
  975.           statement:
  976.  
  977.                NODE D/NYNYO 2400
  978.                212    xxx xxx xxx xxx
  979.                212    xxx xxx xxx xxx
  980.                PREFIX 1-718-
  981.                718    xxx xxx xxx xxx
  982.                718    xxx xxx xxx xxx
  983.  
  984.           The sample file included should make this clear.
  985.  
  986.           Any line that does not start with an area code or the words NODE
  987.           or PREFIX will be treated as a comment line.  The sample file
  988.           uses semi-colons, but almost anything could have been used.
  989.  
  990.           The PCP.INP file is an Opus dialer script with two modifications.
  991.           Special markers indicate where the outdial node and the special
  992.           area-code prefix must be dialed.  When the script is customized,
  993.           the outdial node from the NODE statement will be inserted.  If
  994.           there is an area-code prefix, then it will be inserted as well.
  995.           The two spots where these prefixes are to be inserted are
  996.           indicated by statements starting in column one:
  997.  
  998.                <<<NODE>>>
  999.                <<<PREFIX>>>
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.      XLAXNODE                                                       Page 16
  1012.  
  1013.      XLAXNODE                                                       Page 17
  1014.  
  1015.           The <<<NODE>>> statement causes the program to insert a line
  1016.           like:
  1017.  
  1018.                XMIT NYNYO
  1019.  
  1020.           into the output script.  The <<<PREFIX>>> statement causes a line
  1021.           like:
  1022.  
  1023.                XMIT 1-718-
  1024.  
  1025.           to be generated if needed.  If not, it will be suppressed.
  1026.  
  1027.           The specialized scripts will have file names PCP.1, PCP.2, etc.
  1028.  
  1029.           DIAL processing is very generalized, and works on the basis of
  1030.           string matches.  In order to work with international phone
  1031.           numbers, it makes no assumptions about their format or
  1032.           punctuation.  PURSUIT processing does a rigorous edit of the
  1033.           number.  It must look like "1-NNN-NNN-NNNN"; exactly fourteen
  1034.           characters long, start with a "1" and have three hyphens where
  1035.           indicated.  The other characters must all be numbers, and the
  1036.           middle digit of the area code must be a zero or a one.
  1037.  
  1038.           How does PC Pursuit Processing interact with DIAL processing?  An
  1039.           area code/prefix that you fully specify in the DIAL list will
  1040.           take priority over the Pursuit entry.  An DIAL entry consisting
  1041.           of a shorter string will NOT take priority over the Pursuit
  1042.           entry.
  1043.  
  1044.           What if you live in a Pursuitable city?  You don't want to use
  1045.           Pursuit to make local calls.  Assume both prefixes are listed in
  1046.           PCP.DAT, but 305-555 is local and 305-976 is long distance.  You
  1047.           probably have the following DIAL lines:
  1048.  
  1049.                1-305-555 555
  1050.                1-305     1
  1051.  
  1052.           The DIAL entry that matches 555 is nine characters long, so it
  1053.           would be used, and the call would not be placed with Pursuit.
  1054.           The DIAL entry that matches the 976 number is less than nine
  1055.           characters long, so the Pursuit processing takes priority.
  1056.  
  1057.           If you don't have DIAL entries for your local prefixes, then you
  1058.           will need to disable your own city in the PCP.DAT file.  Just
  1059.           change the baud rate in the NODE statement to zero to disable a
  1060.           city.
  1061.  
  1062.           Suppose you want to bypass Pursuit and use your Super-56000 baud
  1063.           modem for a specific number?  Put the following entry in your
  1064.           DIAL list:
  1065.  
  1066.                1-212-555-1212 1-212-555-1212
  1067.  
  1068.           Since the number is matched by a string of nine or more
  1069.           characters, Pursuit processing is bypassed.
  1070.  
  1071.  
  1072.  
  1073.  
  1074.      XLAXNODE                                                       Page 17
  1075.  
  1076.      XLAXNODE                                                       Page 18
  1077.  
  1078.           Pursuitable nodes will be marked by inserting a ">" character in
  1079.           front of the node's name.  This symbol will be displayed by any
  1080.           program that uses the nodelist files to obtain a nodename.  In
  1081.           addition, the human readable lists (NODETEXT.BBS, NODELIST.PRN,
  1082.           .TXT, .DBL, NODETEXT.BBS and COORD.nnn) will have the PCP node
  1083.           name inserted in front of the node's city.  The NODELIST.FON file
  1084.           will have the word "PCPURSUIT" added to the flags field.
  1085.  
  1086.           NB:  The PCP.INP and PCP.SCR files included are examples.  They
  1087.           probably worked on someone's system, somewhere, sometime.  I
  1088.           don't pretend they will run on your system today.  Pursuit seems
  1089.           sensitive to brands of modems, what city you are calling from,
  1090.           what city your are calling to, the day of the week and the phase
  1091.           of the moon.  I don't use Pursuit and I can't debug any scripts.
  1092.  
  1093.  
  1094.      PCPLIST
  1095.      NOPCPLIST
  1096.  
  1097.           PCPLIST causes a file named PCP.PCP to be written.  This file is
  1098.           a compressed version of the data contained in PCP.DAT file.   The
  1099.           program PCP, supplied with XlaxNode, uses this file.  NOPCPLIST
  1100.           is the default, and the file is suppressed.
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.      XLAXNODE                                                       Page 18
  1138.  
  1139.      XLAXNODE                                                       Page 19
  1140.  
  1141.                                  DELIMITED FILE
  1142.  
  1143.      The delimited file is a version of the nodelist formatted to easily
  1144.      import into dBase, Lotus, Reflex or (gag) a BASIC program.  Each node
  1145.      is a single line, consisting of a list of fields separated by commas.
  1146.      Strings are enclosed in quotes.
  1147.  
  1148.      A sample database definition for dBase-III, NODELIST.DBF, is included.
  1149.      The commands USE NODELIST and APPEND NODELIST.DLM DELIMITED will load
  1150.      this database.  You may wish use the MODIFY STRUCTURE command to
  1151.      shorten some of the field lengths before loading.  For Lotus, use the
  1152.      command "File Import Numbers".  Allow a LONG time and a LOT of memory.
  1153.      If you rename the file to type "PRN", the Reflex2 Translate command
  1154.      will accept this file as type "TEXT".  All you need to do is supply
  1155.      field names.
  1156.  
  1157.      The fields, in order, are:
  1158.  
  1159.           Keyword:  Will contain one of the following: "ZONE", "REGION",
  1160.                "HOST", "HUB", "PVT", "HOLD" or "".  "" is a normal node.
  1161.                Down nodes are not included in the file.
  1162.  
  1163.           Zone: an integer.
  1164.  
  1165.           Region: an integer.
  1166.  
  1167.           Net: an integer.
  1168.  
  1169.           Node: an integer.
  1170.  
  1171.           Node Name: a quoted string.
  1172.  
  1173.           Sysop's Name: a quoted string.
  1174.  
  1175.           City: a quoted string.
  1176.  
  1177.           Node Phone: phone number as it appears in the nodelist, a quoted
  1178.                string.  Private nodes will have "-Unpublished-" in this
  1179.                field.
  1180.  
  1181.      For Hold or Private nodes, the remaining fields refer to the host's
  1182.      (hub, net, region, zone) information.  For normal nodes, they contain
  1183.      the node's own information.
  1184.  
  1185.           Dial Phone: phone number after dial translation, a quoted string.
  1186.  
  1187.           Baud: an integer.
  1188.  
  1189.           Pursuit City: if Pursuit processing enabled and node is dialable
  1190.                via Pursuit, the outdial city, in quotes.  Otherwise "".
  1191.  
  1192.           CM: continuous mail indicator, the letter T or F, not quoted.
  1193.  
  1194.           Flags: a quoted string.
  1195.  
  1196.      This example has been wrapped to fit the format of the document.  In
  1197.  
  1198.  
  1199.  
  1200.      XLAXNODE                                                       Page 19
  1201.  
  1202.      XLAXNODE                                                       Page 20
  1203.      the file, it occupies a single line.
  1204.  
  1205.           "ZONE",1,1,0,"Intl FidoNet Coord","David Dodell","Scottsdale AZ",
  1206.           "1-602-235-9653","1-602-235-9653",1200,"AZPHO",T,"XP:,#CM:"
  1207.  
  1208.  
  1209.                                     CAPACITY
  1210.  
  1211.      XlaxNode has no limit on the size of the nodelist that it can process.
  1212.      Its use of memory is quite dynamic, and it's hard to say how much
  1213.      memory is required.  I've handled substantial control files (including
  1214.      full PC Pursuit processing) in 256k.  The options that invoke the sort
  1215.      (SEADOG, INTERLIST, USERLIST and SINDEX), will add to the time and
  1216.      memory requirements.  All sorts attempt to process the entire file in
  1217.      memory, but will overflow to disk if required.
  1218.  
  1219.      DIAL, COST, PASSWORD, BAUD, PHONE, HUB, and xGATE information are
  1220.      contained in arrays.  One DIAL or COST element is used for each
  1221.      translation line in the control file.  One BAUD, PASSWORD, or PHONE
  1222.      element is used for each net/node line in the control file.  HUB and
  1223.      all xGATE entries share an array, using one element for each net/node
  1224.      in the control file.
  1225.  
  1226.      After the control file is scanned, the program will report how large
  1227.      these arrays are and how many entries were used.  It will also report
  1228.      the size of the heap and how much of it was used.  Since the sort will
  1229.      use all the remaining heap, the report is done before the sort's
  1230.      allocation.
  1231.  
  1232.      If you need to change the size of these arrays, you can create a text
  1233.      file named XLAXNODE.CFG.  This file can be in the current directory or
  1234.      any of the directories in the DOS PATH.  The format is simple.  Each
  1235.      line consists of one of the words: BAUD, COST, DIAL, GATE, PASSWORD,
  1236.      FLAG, PHONE or PURSUIT, followed by an equal sign and an integer that
  1237.      specifies the size of the array.  No comments, spaces, blank lines,
  1238.      etc. are allowed.  For example:
  1239.           COST=200
  1240.           DIAL=100
  1241.           PASSWORD=175
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.      XLAXNODE                                                       Page 20
  1264.  
  1265.      XLAXNODE                                                       Page 21
  1266.  
  1267.  
  1268.             BUGS, PROBLEMS, COMPLAINTS, SUGGESTIONS and COMPLEMENTS
  1269.  
  1270.      Hopefully there will not be a lot of the first three.  If you need
  1271.      help, do ALL of the following:
  1272.  
  1273.           If running any kind of network, multitasker, or TSR, try the
  1274.           problem in a stand alone environment.  The prime rule is "If I
  1275.           can't reproduce the problem I can't fix it."
  1276.  
  1277.           If you are running any kind of odd hardware or old operating
  1278.           system (MS-DOS version 2.1), try to get a friend to run it on a
  1279.           more common configuration.
  1280.  
  1281.           If you are having trouble with Pursuit scripts, you are on your
  1282.           own.  I don't use Pursuit, and have no way to debug a script.
  1283.           The scripts provided are examples and I don't pretend they will
  1284.           run on your system.
  1285.  
  1286.           Send a netmail message, addressed to Scott Samet at 1:135/990.  I
  1287.           have no way to reply to OtherNet addresses, so make sure your
  1288.           message originates from a FidoNet node.
  1289.  
  1290.           Indicate the version number of XlaxNode you are running.
  1291.  
  1292.           Include the type of machine (IBM PS/50, Homemade AT clone), the
  1293.           name (MS-DOS, PC-DOS) and version number of your operating
  1294.           system.
  1295.  
  1296.           Indicate the total memory size and the amount of available memory
  1297.           displayed by ChkDsk or Mapmem.  I may have to restrict my memory
  1298.           to recreate the problem.
  1299.  
  1300.           Indicate any options you are using on the XlaxNode command line.
  1301.           If none, say none, so I don't have to guess.
  1302.  
  1303.           Create an archive that contains a copy of your control file
  1304.           (don't forget included files), your XlaxNode.Cfg file, if any,
  1305.           any private nodelists, plus any other information you think may
  1306.           be germane to the error.
  1307.  
  1308.           Copy down the EXACT text of any error message, or better yet,
  1309.           redirect the output to a file and include it in the archive:
  1310.  
  1311.                XlaxNode > Error.Rpt
  1312.  
  1313.           Create an archive that contains a copy of your XlaxNode.Cfg file
  1314.           (if any), control file (don't forget included files), any private
  1315.           nodelists, plus any other information you think may be germane to
  1316.           the error.  Make YOUR node number part of the archive name so I
  1317.           don't have to figure out where XlaxNode.Ctl came from.
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.      XLAXNODE                                                       Page 21
  1327.  
  1328.      XLAXNODE                                                       Page 22
  1329.                            COMMAND SUMMARY and INDEX
  1330.  
  1331.  
  1332.                ADDR ........................................... 6
  1333.                ADDRLIST filename .............................. 6
  1334.                ALLZONES ...................................... 11
  1335.                BAUD [<zone>:[<net>/]]<node> <speed> .......... 10
  1336.                BUFFERS <number> .............................. 11
  1337.                COMMENTS ....................................... 7
  1338.                COORDLIST ...................................... 7
  1339.                COST <domestic> <international> [<special>] ... 14
  1340.                COUNTRY ........................................ 4
  1341.                DASH ........................................... 7
  1342.                DELIMITEDFILE .................................. 8
  1343.                DIAL <domestic> <international> ............... 12
  1344.                FIDO ........................................... 5
  1345.                FIDODBL ........................................ 5
  1346.                FIDOPRN ........................................ 5
  1347.                FIDOTXT ........................................ 5
  1348.                FLAG [<zone>:[<net>/]]<node> <+/=><flagstring>  10
  1349.                FRONTDOOR ...................................... 8
  1350.                GATE  [<zone>:[<net>/]]<node> .................. 9
  1351.                HUB   [<zone>:[<net>/]]<node> .................. 9
  1352.                IGATE [<zone>:[<net>/]]node .................... 9
  1353.                INCLUDE filename ............................... 4
  1354.                INDEX .......................................... 5
  1355.                INTERLIST ...................................... 6
  1356.                MAXBAUD nnnn [flag mmmm] ....................... 8
  1357.                MYLIST  <filename>... .......................... 9
  1358.                NOCOMMENTS ..................................... 7
  1359.                NOCOORDLIST .................................... 7
  1360.                NODASH ......................................... 7
  1361.                NODE <zone>:<net>/<node> ....................... 4
  1362.                NODELIMITEDFILE ................................ 8
  1363.                NODELIST ....................................... 7
  1364.                NODETEXT [<headerfilename> [<trailerfilename>]]  6
  1365.                NOFIDOLIST ..................................... 5
  1366.                NOFRONTDOOR .................................... 8
  1367.                NOINDEX ........................................ 5
  1368.                NONODELIST ..................................... 7
  1369.                NONODETEXT ..................................... 6
  1370.                NOOPUSLIST ..................................... 7
  1371.                NOPROGRESS ..................................... 6
  1372.                NOREPORT ....................................... 6
  1373.                NOROUTE ........................................ 9
  1374.                NOSEADOGLIST ................................... 7
  1375.                NOSQUEEZE ...................................... 5
  1376.                NOUSERLIST ..................................... 6
  1377.                NOWARTS ....................................... 11
  1378.                OGATE [<zone>:[<net>/]]<node> .................. 9
  1379.                ONEZONE ....................................... 11
  1380.                OPUS ........................................... 5
  1381.                OPUSLIST ....................................... 7
  1382.                OPUSNEW ........................................ 7
  1383.                OPUSOLD ........................................ 7
  1384.                OZONE <zone>:<net>  [<newnet>] ................ 11
  1385.                PASSWORD [<zone>:[<net>/]]<node> password ..... 10
  1386.  
  1387.  
  1388.  
  1389.      XLAXNODE                                                       Page 22
  1390.  
  1391.      XLAXNODE                                                       Page 23
  1392.                PASSWORDFILE filename ......................... 10
  1393.                PCPLIST ....................................... 18
  1394.                PHONE [<zone>:[<net>/]]<node> <phonenumber> ... 10
  1395.                PROGRESS ....................................... 6
  1396.                PUBLIST nodelistname  .......................... 8
  1397.                PURSUIT <filename> <cost> <baud> .............. 15
  1398.                PVTLIST <filename>... .......................... 9
  1399.                REPORT ......................................... 6
  1400.                ROUTE .......................................... 9
  1401.                SEADOG ......................................... 5
  1402.                SEADOGLIST ..................................... 7
  1403.                SINDEX ......................................... 5
  1404.                SORTWORK filename ............................. 11
  1405.                SQUEEZE ........................................ 5
  1406.                UPDATE command-string .......................... 4
  1407.                USERLIST ....................................... 6
  1408.                WARTS ......................................... 11
  1409.                   BUGS, PROBLEMS, COMPLAINTS, SUGGESTIONS and
  1410.                COMPLEMENTS ................................... 21
  1411.                Warranty ....................................... 2
  1412.                License ........................................ 1
  1413.                Acknowledgements ............................... 1
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.      XLAXNODE                                                       Page 23